home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / macros / text1 / cms_help_files / mcf.helpmark < prev    next >
Text File  |  1991-10-23  |  15KB  |  261 lines

  1. +-----------------------------------------------------------------------------+
  2. |                              multicolumnformat                              |
  3. +-----------------------------------------------------------------------------+
  4.  
  5. \multicolumnformat{
  6.     \twocolumnwidth{.48\galleywidth}
  7.     \threecolumnwidth{.31\galleywidth}
  8.     \twocolumngutter{.04\galleywidth}
  9.     \threecolumngutter{.035\galleywidth}
  10.     \columnrulewidth{0.0pt}
  11.     \skipbefore{6pt plus3pt minus2pt}
  12.     \skipafter{6pt plus3pt minus2pt}
  13.                 }
  14.  
  15. Abbreviation:  π|\mcfπ%
  16.  
  17. Parameters:    π|submarkupπ%
  18.  
  19. Submarkup:     π|\twocolumnwidth, \threecolumnwidth,
  20. \twocolumngutter, \threecolumngutter, \columnrulewidth,
  21. \skipbefore, \skipafterπ%
  22.  
  23.     π|Description:π%
  24. The   column  and   gutter   widths  can   be  changed   by   modifying  the
  25. \multicolumnformat  markup.   Column  widths are  specified in  a percentage
  26. of the  \galleywidth, the width  of the text  area on the  page as specified
  27. in the  \pageformat markup.   If the default "flexibleformat"  is being used
  28. a  skip before  and a  skip after  the multiple  column  format may  also be
  29. specified.  These skips are ignored if you are using \fixedformat.
  30.  
  31. π|\twocolumnwidthπ% is  the width of each column  when you specify \twocolumns.
  32. Each column will be  exactly the same width.   This width is the shaded area
  33. illustrated below:
  34. +-----------------------------------------------------------------------------+
  35. |                                                                             |
  36. | Greek        man-     from  the  fourth                                     |
  37. | uscripts  of  the     to   the    ninth                                     |
  38. | Bible  fall  into     centuries,    be-                                     |
  39. | 3 groups (1)  Pa-     ginning with  the                                     |
  40. | pyri,    covering     Codex   Vaticanus                                     |
  41. | the  period  from     and   the   Codex                                     |
  42. | the  third   cen-     Sinaiticus;   (3)                                     |
  43. | tury  b.c.     to     Vellum     minis-                                     |
  44. | the  fourth  cen-     cules,  from  the                                     |
  45. | tury  a.d.    (2)     ninth     century                                     |
  46. | Vellum  uncials--     to   the   inven-                                     |
  47. | -a  form  of  ma-     tion  of   print-                                     |
  48. | juscule    (large     ing,   there  are                                     |
  49. | letter)---            well  over  4,000                                     |
  50. | of various  dates     manuscripts.                                          |
  51. |                                                                             |
  52. +-----------------------------------------------------------------------------+
  53.  
  54. π|\threecolumnwidthπ%    is  the  width   of  each  column   when  you  specify
  55. \threecolumns.     Each column  will  be  exactly  the  same  width.    This
  56. width is the shaded area illustrated below:
  57.  
  58. +-----------------------------------------------------------------------------+
  59. |                                                                             |
  60. | Greek  manu-  (2)  Vellum   icanus   and                                    |
  61. | scripts   of  uncials-     the    Codex                                     |
  62. | the    Bible  --a    form   Sinaiticus;                                     |
  63. | fall    into  of   majus-   (3)     Vel-                                    |
  64. | 3    groups:  cule (large   lum   minis-                                    |
  65. | (1)  Papyri,  letter)--    cules,  from                                     |
  66. | covering      -of  various the    ninth                                     |
  67. | the   period  dates  from   century   to                                    |
  68. | from     the  the  fourth   the   inven-                                    |
  69. | third   cen-  to      the   tion                                            |
  70. | tury    b.c.  ninth  cen-   of    print-                                    |
  71. | to       the  turies, be-   ing,   there                                    |
  72. | fourth  cen-  ginning      are     over                                     |
  73. | tury    a.d.  with    the   4,000  manu-                                    |
  74. |               Codex   Vat- scripts.                                         |
  75. |                                                                             |
  76. +-----------------------------------------------------------------------------+
  77.  
  78. π|\twocolumngutterπ%  is  the  distance between  each column  when  you specify
  79. \twocolumns.  The gutter is the shaded area illustrated below:
  80. +-----------------------------------------------------------------------------+
  81. |                                                                             |
  82. | Greek        man-     from  the  fourth                                     |
  83. | uscripts  of  the     to   the    ninth                                     |
  84. | Bible  fall  into     centuries,    be-                                     |
  85. | 3 groups (1)  Pa-     ginning with  the                                     |
  86. | pyri,    covering     Codex   Vaticanus                                     |
  87. | the  period  from     and   the   Codex                                     |
  88. | the  third   cen-     Sinaiticus;   (3)                                     |
  89. | tury  b.c.     to     Vellum     minis-                                     |
  90. | the  fourth  cen-     cules,  from  the                                     |
  91. | tury  a.d.    (2)     ninth     century                                     |
  92. | Vellum  uncials--     to   the   inven-                                     |
  93. | -a  form  of  ma-     tion  of   print-                                     |
  94. | juscule    (large     ing,   there  are                                     |
  95. | letter)---            well  over  4,000                                     |
  96. | of various  dates     manuscripts.                                          |
  97. |                                                                             |
  98. +-----------------------------------------------------------------------------+
  99.  
  100. π|\threecolumngutterπ%  is the  distance between  each column when  you specify
  101. \threecolumns.  Each  gutter will be exactly the same  width.  The gutter is
  102. the shaded area illustrated on the next page:
  103. +-----------------------------------------------------------------------------+
  104. |                                                                             |
  105. | Greek  manu-  (2)  Vellum   icanus   and                                    |
  106. | scripts   of  uncials-     the    Codex                                     |
  107. | the    Bible  --a    form   Sinaiticus;                                     |
  108. | fall    into  of   majus-   (3)     Vel-                                    |
  109. | 3    groups:  cule (large   lum   minis-                                    |
  110. | (1)  Papyri,  letter)--    cules,  from                                     |
  111. | covering      -of  various the    ninth                                     |
  112. | the   period  dates  from   century   to                                    |
  113. | from     the  the  fourth   the   inven-                                    |
  114. | third   cen-  to      the   tion                                            |
  115. | tury    b.c.  ninth  cen-   of    print-                                    |
  116. | to       the  turies, be-   ing,   there                                    |
  117. | fourth  cen-  ginning      are     over                                     |
  118. | tury    a.d.  with    the   4,000  manu-                                    |
  119. |               Codex   Vat- scripts.                                         |
  120. |                                                                             |
  121. +-----------------------------------------------------------------------------+
  122.  
  123. π|\columnrulewidthπ%  when set to  a non zero  value will print  a rule between
  124. each column.
  125.  
  126. π|\skipbeforeπ%  is the distance between  the one column text  and the multiple
  127. column  text when  you are  using the  flexible  method of  setting multiple
  128. columns.  The skip is ignored if you are using \fixedformat.
  129.  
  130. π|\skipafterπ%  is the distance  between the multiple  column text  and the one
  131. column  text when  you are  using the  flexible  method of  setting multiple
  132. columns.  The skip is ignored if you are using \fixedformat.
  133.  
  134.     π|Example:π%
  135. You can  also specify the  column widths in  units of measure,  instead of a
  136. percentage of the \galleywidth.
  137.  
  138.    \multicolumnformat{
  139.         \twocolumnwidth{10pc}
  140.         \twocolumngutter{3pc}
  141.         \columnrulewidth{.25pt}
  142.  
  143.         \skipbefore{6pt plus3pt minus2pt}
  144.         \skipafter{6pt plus3pt minus2pt}}
  145.  
  146.    \twocolumns
  147.    Greek manuscripts of the Bible fall into 3 groups
  148.    (1) {\it Papyri}, covering the period from the third century
  149.    {\caps b.c} to the fourth century {\caps a.d}.
  150.    (2) {\it Vellum uncials}---a form of majuscule (large
  151.    letter)---of various dates from the fourth to the ninth
  152.    centuries, beginning with the {\it Codex Vaticanus} and
  153.    the {\it Codex Sinaiticus};
  154.    (3) {\it Vellum miniscules}, from the ninth century to
  155.    the invention of printing, there are well over
  156.    4,000 manuscripts.
  157.    \onecolumn
  158.  
  159. +-----------------------------------------------------------------------------+
  160. |                                                                             |
  161. |     Greek   manu-   .   from the  fourth                                    |
  162. | scripts   of  the   .   to   the   ninth                                    |
  163. | Bible  fall  into   .   centuries,   be-                                    |
  164. | 3  groups (1) Pa-   .   ginning with the                                    |
  165. | pyri,    covering   .   Codex  Vaticanus                                    |
  166. | the  period  from   .   and  the   Codex                                    |
  167. | the   third  cen-   .   Sinaiticus;  (3)                                    |
  168. | tury  b.c.     to   .   Vellum    minis-                                    |
  169. | the  fourth  cen-   .   cules, from  the                                    |
  170. | tury  a.d.    (2)   .   ninth    century                                    |
  171. | Vellum  uncials--   .   to  the   inven-                                    |
  172. | -a  form  of  ma-   .   tion  of  print-                                    |
  173. | juscule    (large   .   ing,  there  are                                    |
  174. | letter)---          .   well  over  4,000                                   |
  175. | of  various dates   .  manuscripts.                                         |
  176. |                                                                             |
  177. +-----------------------------------------------------------------------------+
  178.  
  179.     π|Notes:π%
  180.  
  181. The rule between the columns will not print as long as the column rule width
  182. is zero.
  183.     The skip before and skip  after are ignored in the optional fixed column
  184. method.   The fixed column format (\fixedformat)  always fills the remainder
  185. of the current  page with white space  and changes to the  new format on the
  186. following page.  Columns may not be balanced in \fixedformat.
  187.     The  \newcolumn  markup  while  in  the  flexible format  estimates  the
  188. remaining space  on the  page at  the time  it is  entered.   If  a footnote
  189. or other  insert is placed on  the same page after  the newcolumn markup the
  190. length of  the blank  column cannot be  estimated properly.   In  this case,
  191. TEXT1 will issue a warning,
  192.  
  193. overfull \vbox 12pt while \output active
  194.  
  195. You  can compensate  for the  footnote or  insert  by subtracting  twice the
  196. amount of  the overfull  box in two  columns or  three times this  amount in
  197. triple columns immediately before the newcolumn markup.  For example, if the
  198. box is overfull by 12 points and you are in two columns, enter,
  199.  
  200. \advance\vsize by-24pt
  201. \newcolumn
  202. text
  203.  
  204. or in three columns before a \newcolumn enter,
  205.  
  206. \advance\vsize by-36pt
  207. \newcolumn
  208. text
  209.  
  210. This reduces  the height of the  current page enough to  allow space for the
  211. insert.   The height  of each column  must be  reduced by the  amount of the
  212. overfull box  warning, or twice the  amount for two columns  and three times
  213. the amount for three columns.  See The TEXbook for more on \advance.
  214.     If the  newcolumn markup appears  on the final  page of  the document it
  215. may cause  the balance  columns routine  to fail  because one column  is the
  216. full height  of the  page.   Do  not change  to \fixedformat  after entering
  217. \newcolumn.
  218.  
  219.     Certain line breaking penalties have been altered in the multiple column
  220. formats.   These penalties, in combination or  separately, may cause a short
  221. column if there are not a sufficient number of places specified to add extra
  222. space, "glue."
  223.  
  224.                            Single Column Penalties
  225. \brokenpenalty=100                                          \clubpenalty=150
  226. \exhyphenpenalty=50                                        \hyphenpenalty=50
  227. \widowpenalty=150                                             \hbadness=1000
  228. \tolerance=200
  229.                             Two Columns Penalties
  230. \brokenpenalty=0                                              \clubpenalty=0
  231. \exhyphenpenalty=0                                          \hyphenpenalty=0
  232. \widowpenalty=0                                               \hbadness=6400
  233. \tolerance=6400
  234.                            Three Columns Penalties
  235. \brokenpenalty=0                                              \clubpenalty=0
  236. \exhyphenpenalty=0                                          \hyphenpenalty=0
  237. \widowpenalty=0                                               \hbadness=9600
  238. \tolerance=9600
  239.  
  240. The penalties may  be reinstated in the multiple  column formats by entering
  241. each markup with a new value  in the text stream immediately after the first
  242. call for  the double or triple  column markup.   Refer to The  TEXbook for a
  243. discussion of the above penalties.
  244.     When formatting  multiple column text and  other large formatting tasks,
  245. the user  may run into  trouble by calling  for so many  format changes that
  246. the available  memory space is overrun.   If this  happens reduce the number
  247. of markup used  on the page that  fails to format.   The numbers enclosed in
  248. angle brackets < 1 > < 2 > < 3 > show how many pages have been completed and
  249. are printed on the terminal screen  as each page is completed.  If the macro
  250. memory was exceeded when < 3 > was the last number in the sequence you would
  251. know that  the memory was  exceeded while formatting  page four.   Your file
  252. will not print with this error condition.
  253.     To find  the point  in your  document that  exceeded the memory  use the
  254. markup  \bye at  different places  in your  file.    This markup  stops text
  255. processing.  At the point  \bye doesn't prevent the error condition you know
  256. that you have passed page 4  where the error occurred.  You may then examine
  257. the markup  before the  \bye for possible  elimination or  find other markup
  258. that will format  properly without overrunning the memory.   See The TEXbook
  259. for more on \bye.
  260.  
  261.